home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / lisp / stk-3.002 / stk-3 / STk-3.1 / README < prev    next >
Encoding:
Text File  |  1996-07-24  |  7.9 KB  |  234 lines
  1.  
  2.             This is the release 3.1 of STk
  3.            --------------------------------
  4.  
  5.  
  6. (Last release is always available from kaolin.unice.fr [193.48.229.225])
  7.  
  8. STk is a R4RS Scheme interpreter which can access the Tk graphical
  9. package.  Concretely it can be seen as the John Ousterhout's Tk
  10. package where the Tcl language has been replaced by Scheme.
  11.  
  12. STk also provides an efficient object oriented system called STklos.
  13. STklos is an extensive OO system with multiple inheritance, generic
  14. functions, multi-methods and a Meta Object Protocol).
  15.  
  16. This release runs on several Unix boxes (see below) and on Microsoft
  17. Win32. It uses the Tk 4.1 package for the graphical part.
  18.  
  19. DIFFERENCE PREVIOUS RELEASE
  20. ---------------------------
  21.  
  22.     - Version of Tk is now at Tk4.1 level. 
  23.  
  24.     - STk run now on Win32!!! 
  25.     Some details need a little more work (some oddities on file names
  26.     due to difference conventions between Unix and DOS, and things like 
  27.     that). No socket support and no dynamic loading on Win32
  28.  
  29.     - A complete documentation of STk widgets pages (both in nroff 
  30.     and HTML format). The help command really allow you to browse
  31.     man pages now. Man pages are prefixed by "stk_" now to avoid confusion 
  32.     with original Tk manual pages. 
  33.  
  34.     - STklos is now integrated to STk (it was dynamically loaded before).
  35.       This simplify its implementation and speed up generic functions:
  36.         o gf are now 2-4 time faster
  37.         o gf are now tail recursive
  38.         o the MOP for gf is now "public" (i.e. you can change the way 
  39.           gf are called in Scheme -- it was not possible with previous 
  40.           versions without using C).
  41.  
  42.     - Port implementation is different: A port contains now its
  43.     input and output handler. New primitives to access the handler:
  44.     when-port-readable and when-port-writable.
  45.     BTW, The Tk function fileevent function is no more useful
  46.     (it is written in Scheme now for compatibility, but its usage 
  47.     is deprecated). It may not be supported in a future release.
  48.  
  49.     - New composite widgets: <Multiple-window> and <Inner-window>
  50.     which allow to have embedded windows. A multiple window 
  51.     has a task bar below and allow to iconify inner-windows. 
  52.     Some people think it looks like Win95 desktop ;-)    
  53.  
  54.     - pixmap extension doesn't require anymore the Xpm library. Code
  55.     is stolen from the Tix Library.
  56.  
  57.     - New socket code which allow multiple concurrent connection
  58.  
  59.     - Extended types can now have a compare function which    is called
  60.      when eqv? or equal? is called. This modification should be 
  61.      compatible with the previous extensions (I hope so)
  62.     
  63.     - STklos: Two new methods: object-eqv? and object-equal? which are 
  64.     called when applying eqv? or equal? to instances.
  65.  
  66.     - A rewriting of bind-for-dragging canvas method. You can now specify 
  67.     a :before-motion, which if it returns #f, forbid to move the selected 
  68.     canvas item.
  69.  
  70.     - New primitives:setenv!, posix-host-name, posix-domain-name, 
  71.     posix-uname      
  72.     
  73.     - Option separator "--" allows to pass reserved keyword 
  74.       (such as -help) to a script. Option and parameter cannot
  75.        be mixed anymore:
  76.         stk xyz -help ==> *argv* = ("xyz" "-help")
  77.  
  78.     - HTML browser enhancement (support of the <FONT> tag with SIZE 
  79.       and COLOR sub-tags. This must be compatible with the HTML spec. 
  80.  
  81.     - and of course many many bug corrections.
  82.  
  83. See file 'CHANGES' in the distribution main directory for more informations.
  84.  
  85. SCHEME WITHOUT TK
  86. -----------------
  87.  
  88. Standard make build a light version of STk which does not provide support for
  89. the Tk toolkit. This interpreter, called Snow (Scheme with NO Window), can be
  90. called directly with the 'snow' shell script. It is implicitly called if 
  91. your DISPLAY variable is not set.
  92.  
  93. LEARNING STk
  94. ------------
  95.  
  96. In Contrib/STk-wtour, you'll find a program (called stk-wtour) which is a kind
  97. of tutorial for programming widgets in STk. This program, which is a
  98. contribution of Suresh Srinivas (ssriniva@cs.indiana.edu), is an excellent 
  99. starting point for learning basics of STk widgets programming.
  100.  
  101. FILE ORGANIZATION
  102. -----------------
  103.  
  104. Stk
  105.   |___ Contrib       The contributors directory
  106.   |___ Demos       some original Tk demos rewritten for stk plus some other
  107.   |                stuff found on  the net. 
  108.   |___ Extensions  This directory contains extensions of the core interpreter
  109.   |           (hash tables, POSIX.1 support). See the README file for more 
  110.   |           details
  111.   |___ Doc       Documentation of STk.           
  112.   |___ Help       Various (HTML) help files for STk.
  113.   |___ Lib       a set of Scheme files used by the interpreter
  114.   |___ Src       contains source files of stk (i.e. the sources files of the 
  115.   |           interpreter + some glue files between Tk and Scheme).
  116.   |___ Snow       contains (mostly) links over Src files. This directory 
  117.   |           is used to build snow the Scheme interpreter without Tk
  118.   |           support
  119.   |___ STklos      an CLOS-like object extension of Scheme based on the
  120.   |    |       Tiny CLOS package.
  121.   |    |_ Tk       A library of Tk objects based on the STklos object
  122.   |    |       extension package (subdirectory Composite contains
  123.   |    |       composite widgets definitions    
  124.   |    |_ Examples A (small) set of examples written in STklos.
  125.   |___ Tcl       contains a set of unchanged files of the Tcl library which 
  126.   |           pertain in Stk
  127.   |___ Tk        contains a modified version of the Tk library. Most of the
  128.   |           files are unchanged; Search the string ORIGINAL_CODE to see
  129.   |           performed changes.
  130.   |___ Win32       contains file necessary to compile STk under Win32
  131.  
  132. SUPPORTED ARCHITECTURES
  133. -----------------------
  134.  
  135. For now, STk is known to run on the following machine/systems
  136.  
  137.     - Sparc (SunOs 4.1.x & Solaris 2.{34})
  138.     - Dec 5xxx (Ultrix 4.2)
  139.     - SGI (IRIX 4.05, 5.1.1, 5.2)
  140.     - DEC Alpha 3000/400 (OSF-1 V1.3)
  141.     - RS6000 AIX 3.2.5    
  142.     - HP 9000/735 (HP-UX 9.01)
  143.     - PC (Linux 1.0 -> 2.0)
  144.     - PC (FreeBSD 1.1)       
  145.     - PC (SCO)          
  146.     - PC (NetBSD-1.0)      
  147.     - Sony WS (Sony NEWS, NEWSOS 4.2R)
  148.     - ...
  149.  
  150.     - Windows 95 (and probably Windows NT) 
  151.  
  152. If you install it on another architecture/system, please let me now the
  153. diffs you used such I can integrate them in the next release.
  154.  
  155. The file COMPILING-HINTS may be useful for compiling STk on your system.
  156.  
  157. DYNAMIC LOADING
  158. ---------------
  159.  
  160. Support for dynamic loading is provided for the following architectures/systems
  161.  
  162.         - SunOs 4.1.x
  163.         - SunOs 5.3
  164.         - NetBSD-1.0 (i386-port)
  165.         - Linux (with the DLD package or ELF format). [ Dynamic
  166.           loading is disabled by default. Use -enable-elf or 
  167.           -enable-dld to choose the way you want to make dynamic 
  168.           loading under Linux]
  169.         - FreeBSD
  170.         - HPUX
  171.         - SGI Irix 5.3 
  172.  
  173. IMAGE CREATION
  174. --------------
  175.  
  176. The following architecture support image creation (dumping the interpreter 
  177. memory in a file):
  178.         - SunOs 4.1.x
  179.         - Linux 1.1 (a.out format only)
  180.         - FreeBSD
  181.  
  182. MAILING LIST
  183. ------------
  184.  
  185. Subscription/unsubscription/info requests to the STk mailing list
  186. should be sent to 'stk-request@kaolin.unice.fr'
  187.  
  188. To subscribe to the mailing list, simply send a message with the word
  189. "subscribe" in the "Subject:" field to the following address:
  190. 'stk-request@kaolin.unice.fr'
  191.  
  192. To unsubscribe from the mailing list, simply send a message with the
  193. word (you guessed it :-) "unsubscribe" in the "Subject:" field to
  194. 'stk-request@kaolin.unice.fr'
  195.  
  196. For more information on the mailing list management send a message
  197. with the word "help" in the Subject: field to the
  198. 'stk-request@kaolin.unice.fr'
  199.  
  200. Subscription requests are processed automatically without human
  201. intervention. If you have a problem, send a mail to
  202. eg@kaolin.unice.fr.
  203.  
  204. Messages sent to the mailing list are archived 
  205.      - in raw format at 
  206.         ftp://kaolin.unice.fr/pub/Mailing-list/
  207.      - as hypertext at 
  208.         http://kaolin.unice.fr/Mlist
  209.  
  210. STk W3 HOME PAGE
  211. ----------------
  212.  
  213. The STk W3 home page is located at
  214.     http://kaolin.unice.fr/STk.html
  215.  
  216. BUGS
  217. ----
  218.  
  219. If you find a bug, please report it to stk-bugs@kaolin.unice.fr. 
  220.  
  221. AUTHOR ADDRESS
  222. --------------
  223.  
  224. Erick Gallesio                      tel : (33) 92-96-51-53
  225. ESSI - I3S                      fax : (33) 92-96-51-55
  226. Universite de Nice - Sophia Antipolis        email : eg@unice.fr
  227. Route des colles
  228. BP 145
  229. 06903 Sophia Antipolis CEDEX
  230. FRANCE
  231.  
  232.      
  233.  
  234.